Skip to content

[action-translation] resync: eig_circulant.md#109

Merged
mmcky merged 2 commits into
mainfrom
resync/eig_circulant
Jul 19, 2026
Merged

[action-translation] resync: eig_circulant.md#109
mmcky merged 2 commits into
mainfrom
resync/eig_circulant

Conversation

@mmcky

@mmcky mmcky commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Forward Resync: eig_circulant.md

Source: QuantEcon/lecture-python.mystlectures/eig_circulant.md
Source commit: 6a512f1
This PR resyncs the translation to match the current source document.

Reason: Several substantive omissions and alterations exist in the target: missing intro sentence about circulant matrices' connection to convolution and eigenvectors via DFT and cross-reference links to linear_algebra and hoist_failure docs; missing 'For background...' sentence; summation index changed from N-1 to n-1 in convolution formula (inconsistent with source); det formula rendered differently (missing parentheses/minus sign nuance, though minor); C^T rendered as C^T vs C' inconsistently; PP^T changed to PP' notation; missing explicit mention 'Suppose A and B are circulant matrices of same order and same cyclic shift convention' (simplified); code renamed (construct_circulant -> construct_cirlulant, DFT function inverse_DFT -> inverse_transform, added @jit decorators and numba import, added font-loading code) - font/jit are i18n/tooling but inverse_DFT function rename and eigenvector printing Q[:, i] changed to Q[i, :] is a functional discrepancy; formula for eigenvalue of C8 changed variable names and added extra clause 'where w^{k-1} is P8's corresponding eigenvalue' not in source; plot_magnitude X-axis label changed from 'k' to 'j'; overall multiple content-level formula/variable inconsistencies beyond mere style, requiring review against source.

Changes

Whole-file resync applied. The entire document was resynced in a single pass.


Created by action-translation forward resync

Copilot AI review requested due to automatic review settings July 18, 2026 07:25
@mmcky mmcky added action-translation-sync CLI resync PR (translate forward --github) resync Forward resync labels Jul 18, 2026
@netlify

netlify Bot commented Jul 18, 2026

Copy link
Copy Markdown

Deploy Preview for astonishing-narwhal-a8fc64 ready!

Name Link
🔨 Latest commit 6b5cb13
🔍 Latest deploy log https://app.netlify.com/projects/astonishing-narwhal-a8fc64/deploys/6a5c4cbabc1dbd0008874ebd
😎 Deploy Preview https://deploy-preview-109--astonishing-narwhal-a8fc64.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR forward-resyncs the Chinese translation of the eig_circulant lecture to better match the upstream source document, updating both the mathematical exposition and the accompanying Python code cells, and recording resync state metadata.

Changes:

  • Added translation frontmatter metadata and restored missing/updated explanatory text (including cross-references).
  • Updated math notation and formulas (e.g., convolution index bounds, transpose notation, determinant expression).
  • Renamed/standardized helper functions used in code cells (e.g., construct_circulant, construct_cyclic_shift_matrix, inverse_DFT) and adjusted related narrative.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
lectures/eig_circulant.md Resynced lecture content, math, and code cells to match source; adds translation metadata and updates multiple formulas/names.
.translate/state/eig_circulant.md.yml Records resync provenance (source SHA/date/model/mode).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread lectures/eig_circulant.md
Comment on lines 98 to 100
```{code-cell} ipython3
@jit
def construct_cirlulant(row):
def construct_circulant(row):

Comment thread lectures/eig_circulant.md
Comment on lines +352 to 354
# 验证正交性(酉性)
Q8 @ np.conjugate(Q8)
```
@mmcky mmcky added the action-translation PRs created by QuantEcon/action-translation label Jul 18, 2026
@github-actions

github-actions Bot commented Jul 18, 2026

Copy link
Copy Markdown

@github-actions
github-actions Bot temporarily deployed to pull request July 18, 2026 10:30 Inactive
@github-actions

Copy link
Copy Markdown

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-5 | Date: 2026-07-19


📝 Translation Quality

Criterion Score
Accuracy 9/10
Fluency 9/10
Terminology 9/10
Formatting 8/10
Overall 8.9/10

Summary: This is a high-quality translation that accurately and fluently conveys the technical content of the English source, with correct terminology usage throughout. The main concern is the unauthorized addition of extra code (numba import, matplotlib font configuration) in the first code cell that doesn't exist in the source document, which should be reviewed for consistency with translation policy. Minor stylistic improvements could be made to one or two sentences split around display equations, but overall the translation is faithful and well-executed. Excellent accuracy in translating complex mathematical definitions and explanations (e.g., circulant matrix definition, permutation matrix concepts, DFT formulas) Consistent and correct use of standard mathematical/linear algebra terminology (特征值, 特征向量, 置换矩阵, 循环矩阵, 卷积) matching the glossary All LaTeX equations, code blocks, and MyST directives (prf:definition, eq references) are correctly preserved Natural, fluent academic Chinese phrasing throughout, especially in explanatory passages about eigenvalues and roots of unity

Suggestions:

  • Code import block: The translation added extra imports (from numba import jit, matplotlib as mpl, font configuration lines) that are not present in the English source. These should be removed to maintain fidelity to the original document unless this is a standard project-wide convention applied consistently across all translated lectures.
  • 构造循环矩阵 section, 'circulant shift' explanation: '是一个循环移位算子' - the English says 'serves as a cyclic shift operator' which is accurately translated, but consider verifying 'h' variable reference is preserved correctly (it is, this is fine).
  • P的特征向量部分: '对于系数向量 ${c_i}_{i=0}^{n-1}$,$P$ 的特征向量也是 ... 的特征向量' - this splits the sentence awkwardly around the display equation which slightly disrupts the natural flow compared to the source's single-sentence structure; consider rephrasing as '对于系数向量...,P的特征向量同样是如下矩阵的特征向量:' for smoother reading.

🔍 Diff Quality

Check Status
Scope Correct
Position Correct
Structure Preserved
Heading-map Correct
Overall 10/10

Summary: The resync correctly re-aligned the Chinese translation to match the current English source structure, content, and heading metadata.


This review was generated automatically by action-translation review mode.

@github-actions
github-actions Bot temporarily deployed to pull request July 19, 2026 04:28 Inactive
@mmcky
mmcky merged commit 97cf445 into main Jul 19, 2026
7 checks passed
@mmcky
mmcky deleted the resync/eig_circulant branch July 19, 2026 04:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action-translation PRs created by QuantEcon/action-translation action-translation-sync CLI resync PR (translate forward --github) resync Forward resync

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants